Synthesizer Description Structure

A synthesizer description structure contains information about a synthesizer. It is defined by the SynthesizerDescription data type.



 
struct SynthesizerDescription {

    OSType                      synthesizerType;

    Str31                       name;

    unsigned long               flags;

    unsigned long               voiceCount;

    unsigned long               partCount;

    unsigned long               instrumentCount;

    unsigned long               modifiableInstrumentCount;

    unsigned long               channelMask;

    unsigned long               drumPartCount;  

    unsigned long               drumCount;          

    unsigned long               modifiableDrumCount;

    unsigned long               drumChannelMask;

    unsigned long               outputCount;    

    unsigned long               latency;

    unsigned long               controllers[4];

    unsigned long               gmInstruments[4];

    unsigned long               gmDrums[4];

};

typedef struct SynthesizerDescription SynthesizerDescription;

synthesizerType: The synthesizer type. This is the same as the music component subtype.
name: Text name of the synthesizer type.
flags: Various information about how the synthesizer works. Synthesizer Description Flags
voiceCount: Maximum polyphony.
partCount: Maximum multi-timbrality (and MIDI channels).
instrumentCount: The number of built-in ROM instruments. This does not include General MIDI instruments.
modifiableInstrumentCount: The number of slots available for saving user-modified instruments.
channelMask: Which channels a MIDI device always uses for instruments. Set to FFFF for all channels.
drumPartCount: The maximum multi-timbrality of drum parts. For synthesizers where drum kits are separated from instruments.
drumCount: The number of built-in ROM drum kits. This does not include General MIDI drum kits. For synthesizers where drum kits are separated from instruments
modifiableDrumCount: The number of slots available for saving user-modified drum kits. For MIDI synthesizers where drum kits are separated from instruments
drumChannelMask: Which channels a MIDI device always uses for drum kits. Set to FFFF for all channels
outputCount: The number of audio outputs. This is usually two.
latency: Response time in Sec.
controllers[4]: An array of 128 bits identifying the available controllers. Controller Numbers Bits are numbered from 1 to 128, starting with the most significant bit of the long word, and continuing to the least significant of the last bit.
gmInstruments[4]: An array of 128 bits giving the available General MIDI instruments.
gmDrums[4]: An array of 128 bits giving the available General MIDI drum kits.

Previous | Chapter Top | Chapter Contents | Next